home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d17 / pprint13.arc / PPRINT.DOC < prev    next >
Text File  |  1990-08-02  |  6KB  |  146 lines
  1. PPRINT - An enhanced file printing utility
  2. By Mark Margolis
  3.  
  4. Version 1.3
  5.  
  6. IMPORTANT!
  7. ----------
  8.  
  9.      PPRINT can be distributed freely with the following limitations:
  10.  
  11.           1) PPRINT is distributed FREE OF CHARGE
  12.           2) A copy charge of NO MORE THAN $5 is charged for its distribution
  13.           3) PPRINT.EXE and PPRINT.DOC are NOT MODIFIED in any way.
  14.  
  15. WHAT IS PPRINT?
  16. ---------------
  17.  
  18.      PPRINT is an enhanced printing utility. I originally wrote it to print
  19.      out certain sections from the 200+ page DOC files that came with some
  20.      of the public domain and shareware software I downloaded. I continued to
  21.      add and expand to PPRINT, trying to make it useful for a variety of people
  22.      by adding a variety of options. I hope you find it useful, and remember,
  23.      feel free to copy it as much as you want!
  24.  
  25. FEATURES OF PPRINT 1.3
  26. ----------------------
  27.  
  28.      Version 1.3 is the first public release of PPRINT. This version is bug
  29.      free (as far as I can tell) and it seems to do exactly what I want it
  30.      to do. Here is a basic list of the features of PPRINT 1.3:
  31.  
  32.      o Screen/Printer Output - Output can be sent to printer and/or screen
  33.      o Easy Pause - Pressing any key will pause the display/printing
  34.      o Easy Abort - Pressing A will abort the program at any time
  35.      o Auto Pause - If selected, program will pause at the end of each page
  36.      o Page Count - Counts the number of pages in the given file
  37.      o FF Detect  - Will detect a form feed (FF) character and advance page
  38.      o Start/End Page Adjust - User can select which pages to display/print
  39.      o Adjustable Page Length - Set page length to any amount of lines/page
  40.  
  41. USAGE
  42. -----
  43.  
  44.      Format: PPRINT <filename> ? [pglen]
  45.                           or
  46.              PPRINT <filename> [sp] [ep] [F][S][P][-] [pglen]
  47.  
  48.       <filename> is REQUIRED - it specifies the name of the file you want
  49.                                to display or print. Pathnames can be included,
  50.                                but wildcards are not allowed.
  51.  
  52.            ?   Have PPRINT to count the number of pages in <filename>.
  53.  
  54.           sp   The first page to start displaying/printing
  55.           ep   The last page to start displaying/printing
  56.  
  57.            F   Force a new page when a form feed character is encountered
  58.            S   Send output to the screen (default)
  59.            P   Send output to the printer
  60.            -   Automatically pause between pages
  61.  
  62.          pglen A number between 0 and 32767, specifiying the number of lines
  63.                per page. If pglen is not specified, PPRINT will default to 66
  64.                lines per page if output is being sent to the printer, or 23
  65.                lines per page if output is being sent to the screen.
  66.  
  67.  
  68.      A few notes: 1) If just the filename is specified (ie: PPRINT filename),
  69.                      PPRINT will display the entire document to the screen.
  70.                      This is similar to the DOS TYPE command, except PPRINT
  71.                      supports easy abort and easy pausing.
  72.  
  73.                   2) The pglen parameter must always immediately follow either
  74.                      the ep parameter or the options (F,S,P,-,?) parameter(s).
  75.  
  76.                   3) The sp parameter must always be specified when the ep
  77.                      parameter is used.
  78.  
  79.                   4) The F,S,P, and - parameters may be used together. The
  80.                      order in which they fall does not matter. They are not
  81.                      case sensitive. They should not be seperated by spaces.
  82.  
  83.                   5) Pressing the ESC key in the display or print modes of
  84.                      PPRINT will automatically abort PPRINT. Pressing any
  85.                      other key will automatically pause PPRINT. (To resume
  86.                      PPRINT after pausing, press any key except for A.)
  87.  
  88.                   6) Currently, only LPT1 is supported for printing.
  89.  
  90.                   7) Wildcards are NOT supported.
  91.  
  92.                   8) If ANY output goes to the printer (either printer only or
  93.                      printer and screen), the page length will default to 66
  94.                      lines per page.
  95.  
  96.  
  97. A FEW EXAMPLES
  98. --------------
  99.  
  100.      PPRINT mydoc.doc
  101.      [Displays the entire file mydoc.doc]
  102.  
  103.      PPRINT mydoc.doc ?
  104.      [Counts the number of pages in file mydoc.doc, assumes 66 lines per page]
  105.  
  106.      PPRINT mydoc.doc ? 58
  107.      [Counts the number of pages in mydoc.doc, adjusts lines per page to 58]
  108.  
  109.      PPRINT mydoc.doc 20 34
  110.      [Displays pages 20 through 34 of file mydoc.doc]
  111.  
  112.      PPRINT mydoc.doc 48 90 S-PF 45
  113.      [Displays to screen and prints to printer pages 48 through 90 of file
  114.      mydoc.doc If a formfeed is encountered, a new page is assumed. PPRINT
  115.      will automatically pause in between pages. The page length (lines per
  116.      page) has been adjusted to 45.]
  117.  
  118.      PPRINT mydoc.doc 67 -s
  119.      [Displays to screen pages 67 through the last page of file mydoc.doc.
  120.      PPRINT will automatically pause in between pages.]
  121.  
  122. QUESTIONS/COMMENTS
  123. ------------------
  124.  
  125.      If you have any questions/comments/suggestions about PPRINT, feel free
  126.      to call me or write to me. I will return all calls collect. I am a
  127.      college student, so I will not be at this address most of the year,
  128.      however, I will respond to all mail that is sent to this address. I
  129.      will include my internet address in this document as soon as I receive
  130.      it. If you need to contact me, you can write to:
  131.  
  132.                                Mark Margolis
  133.                                2 Boar Court
  134.                                Suffern, NY 10901
  135.  
  136.                                (914)-354-7110 <-- Phone # (obviously)
  137.  
  138. COMING SOON
  139. -----------
  140.  
  141. QBDOORS, a bunch of routines and stuff I wrote to write door programs for
  142. BBS programs. These routines are in QuickBASIC. They seem to work quite
  143. nicely, and I hope to release this progammer's kit sometime soon. These
  144. routines, etc, will be public domain (AKA FREE) as well.
  145.  
  146. Enjoy!